home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / deskjet.z / deskjet
Text File  |  1998-10-30  |  12KB  |  265 lines
  1.  
  2.  
  3.  
  4. DDDDEEEESSSSKKKKJJJJEEEETTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        DDDDEEEESSSSKKKKJJJJEEEETTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      deskjet - HP DeskJet/PaintJet parallel printer driver
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ddddeeeesssskkkkjjjjeeeetttt ----PPPP pppprrrriiiinnnntttteeeerrrrnnnnaaaammmmeeee [ options ] [ inputfile ]
  13.  
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The _d_e_s_k_j_e_t driver is a printer-specific driver for a HP DeskJet 500C,
  17.      550C, 560C, 1200C or PaintJet XL300 printer connected to an SGI
  18.      /dev/plp-compatible parallel port.  _d_e_s_k_j_e_t reads STIFF format image
  19.      files, writes PCL commands to the printer, and uses _l_i_b_p_o_d(_3) functions
  20.      to keep the printer object database (POD) current, thereby providing
  21.      feedback on any engine errors encountered.
  22.  
  23.  
  24.      The driver opens and maintains the POD files for the specified printer.
  25.      For more information on POD files refer to the _l_i_b_p_o_d(_3) and _p_o_d(_4) man
  26.      pages.
  27.  
  28.  
  29.      While ddddeeeesssskkkkjjjjeeeetttt has the parallel port open, no other driver may flock the
  30.      port, thus effectively reserving the printer for exclusive use by
  31.      cooperating drivers.
  32.  
  33.  
  34. IIIINNNNPPPPUUUUTTTT FFFFIIIILLLLEEEE FFFFOOOORRRRMMMMAAAATTTT
  35.      ddddeeeesssskkkkjjjjeeeetttt assumes that its input is coming from standared input unless a
  36.      filename is specified after any and all command line options.
  37.  
  38.  
  39.      ddddeeeesssskkkkjjjjeeeetttt accepts the input files in planar as well as chunky STIFF 1-bit
  40.      format and supports K, CMY, CMYK colorspaces. STIFF is a streamable
  41.      subset of TIFF 6.0.  For more information on the STIFF image file format,
  42.      see the _l_i_b_s_t_i_f_f(_3) man pages.
  43.  
  44.  
  45. UUUUSSSSAAAAGGGGEEEE
  46.      ----PPPP _p_r_i_n_t_e_r_n_a_m_e
  47.                Specifies the printer with which ddddeeeesssskkkkjjjjeeeetttt is communicating.
  48.                _p_r_i_n_t_e_r_n_a_m_e is the name under which the System V R3 spooler
  49.                recognizes the printer, as given on the llllpppp command line.  This
  50.                option is required.
  51.  
  52.  
  53.      ----eeee        Specifies that driver should exit immediately on fault.  By
  54.                default, the driver waits indefinitely for faults to clear,
  55.                retrying any errors every several seconds, where the exact
  56.                number of seconds is defined in the POD config error_retry_wait
  57.                entry.  This option is useful when only a quick inquiry needs
  58.                to be performed.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDEEEESSSSKKKKJJJJEEEETTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        DDDDEEEESSSSKKKKJJJJEEEETTTT((((1111))))
  71.  
  72.  
  73.  
  74.      ----ssss        Specifies that the driver should exit after ascertaining
  75.                printer status and updating the POD status file.  If an error
  76.                is encountered, however, ddddeeeesssskkkkjjjjeeeetttt may block unless the ----eeee switch
  77.                is given as well. If a quick status update is what you want,
  78.                invoke ddddeeeesssskkkkjjjjeeeetttt with both the ----ssss and the ----eeee options to insure
  79.                that ddddeeeesssskkkkjjjjeeeetttt exits promptly.
  80.  
  81.  
  82.      ----wwww        Specify this flag to suppress warning messages in the printer
  83.                status file. By default, warning messages such as the driver
  84.                version or other non-fatal errors are written to the printer
  85.                status file.
  86.  
  87.  
  88.      ----DDDD        Turns on debugging information.  Five levels of debugging
  89.                information are supported: None, CoarseDetail, MediumDetail,
  90.                FineDetail, and EvenFinerDetail.  These correspond to 0, 1, 2,
  91.                3, and 4 or more ----DDDD switches given on the command line.  That
  92.                is, multiple ----DDDD options given on the command line result in
  93.                progressively more detailed debugging information.
  94.  
  95.  
  96.      ----tttt        Prints a test page and performs printer diagnostics.  Use this
  97.                to verify that the printer, cables, and driver are functional.
  98.                This option is useful when trying to narrow down the location
  99.                of an error in printing.  If this fails, either the printer,
  100.                the cable, or the driver (including the /dev/plp device driver)
  101.                is at fault, but the model file, print scheduler, and rendering
  102.                filters are not to blame.
  103.  
  104.  
  105.      ----LLLL _l_o_g_f_i_l_e_n_a_m_e
  106.                Specifies a filename to which error and debug information
  107.                should be appended.  If this option is not specified, error and
  108.                debug information is appended to stderr, which is generally
  109.                redirected by the System V spooler to /var/spool/lp/log.
  110.  
  111.  
  112.      ----RRRR        Reset the parallel port immediately after opening but before
  113.                using it.  This is not the default, but can be a useful feature
  114.                for those recalcitrant printers.  Note that some printers
  115.                ignore the RESET signal altogether.  This includes most HP
  116.                DeskJets.
  117.  
  118.  
  119.      ----3333        Force PCL3 mode.  This disallows any commands specific to PCL4
  120.                or later.  Specifically, PCL3 does not understand the number of
  121.                copies commands or any command which would require a full page
  122.                buffer in the printer: no such page buffer is kept in the
  123.                printer.  If this switch is given, multiple copies will be sent
  124.                by complete retransmission rather than a PCL reprint command.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DDDDEEEESSSSKKKKJJJJEEEETTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        DDDDEEEESSSSKKKKJJJJEEEETTTT((((1111))))
  137.  
  138.  
  139.  
  140.      ----XXXX _H_o_r_i_z_o_n_t_a_l_R_e_s_o_l_u_t_i_o_n
  141.                Specifies the horizontal resolution at which to print, one of
  142.                the following: 75, 100, 150, or 300.  The default is 300. This
  143.                is normally derived from the printer status database, but if
  144.                given, it overrides and will be written to the printer status
  145.                database.
  146.  
  147.  
  148.      ----YYYY _V_e_r_t_i_c_a_l_R_e_s_o_l_u_t_i_o_n
  149.                Specifies the vertical resolution at which to print, one of the
  150.                following: 75, 100, 150, or 300.  The default is 300. This is
  151.                normally derived from the printer status database, but if
  152.                given, it overrides and will be written to the printer status
  153.                database.
  154.  
  155.  
  156.      ----SSSS _P_a_p_e_r_S_i_z_e
  157.                Specifies the papersize to request from the printer.  This may
  158.                be any papersize recognized by libpod(3), _b_u_t _o_n_l_y _t_h_o_s_e _s_i_z_e_s
  159.                _l_i_s_t_e_d _i_n _t_h_e _p_r_i_n_t_e_r _c_o_n_f_i_g_u_r_a_t_i_o_n _f_i_l_e _s_h_o_u_l_d _b_e _u_s_e_d.  _T_h_i_s
  160.                _i_s _n_o_r_m_a_l_l_y _d_e_r_i_v_e_d _f_r_o_m _t_h_e _p_r_i_n_t_e_r _s_t_a_t_u_s _d_a_t_a_b_a_s_e, _b_u_t _i_f
  161.                _g_i_v_e_n, _i_t _o_v_e_r_r_i_d_e_s _a_n_d _w_i_l_l _b_e _w_r_i_t_t_e_n _t_o _t_h_e _p_r_i_n_t_e_r _s_t_a_t_u_s
  162.                _d_a_t_a_b_a_s_e.
  163.  
  164.  
  165.      ----OOOO _f_i_l_e_n_a_m_e
  166.                Output data to _f_i_l_e_n_a_m_e instead of the device port or standard
  167.                output.  The data will not be printed; the data that would have
  168.                been sent to the printer had the ----OOOO option not been specified
  169.                will instead be saved to _f_i_l_e_n_a_m_e.
  170.  
  171.  
  172. EEEEXXXXIIIITTTT CCCCOOOODDDDEEEESSSS
  173.      The driver normally exits with an exit code of zero (0), denoting no
  174.      error.  A number of exit codes are supported to give more information
  175.      about unsuccessful exits.  Remember that the driver will not exit on
  176.      recoverable errors unless the ----eeee switch is given.
  177.  
  178.      The error codes 1 through 18 denote the following meanings, in order:
  179.      unknown error, bad command line or image header arguments, bad POD
  180.      database access, bad device name, bad device type, bad status update,
  181.      unsuccessful device access, bad memory reference, failed memory
  182.      allocation, invalid data format, invalid data header, short or empty
  183.      input data file, short or empty firmware download code file, bad or short
  184.      input data file, failed transmission, data buffer invalid, test print
  185.      failed, firmware download failed.
  186.  
  187.      A common error exit is on empty input: the driver will return error code
  188.      12, indicating a short or empty input file, whenever the PostScript
  189.      interpreter (or another upstream filter) dies before a full page of data
  190.      was written to the driver.  This can happen when bad PostScript code is
  191.      sent to be printed, for instance.  In this case, the spooler log file
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. DDDDEEEESSSSKKKKJJJJEEEETTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        DDDDEEEESSSSKKKKJJJJEEEETTTT((((1111))))
  203.  
  204.  
  205.  
  206.      (/var/spool/lp/log) should be consulted to determine which filter failed;
  207.      an error should have been written to this file by the dying filter or
  208.      driver.
  209.  
  210.  
  211. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  212.      ddddeeeesssskkkkjjjjeeeetttt will not exit on spooler job cancellation (SIGTERM) until its
  213.      input has been completely copied to the output device.  This means that
  214.      if a printer is unable to accept data, cancelling the job will not kill
  215.      the ddddeeeesssskkkkjjjjeeeetttt process.  To do so, you must explicitly kill the process with
  216.      SIGKILL (9).  This behavior is required so that job cancellation does not
  217.      leave the printer in a wedged state: cancelling in the middle of a raster
  218.      page would leave many parallel printers in a bad state which could eat
  219.      several subsequent print jobs.
  220.  
  221.  
  222. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  223.      psrip(1), impressario(1), printstatus(1), printpanel(1), libpod(3),
  224.      libspool(3), libstiff(3).
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.